Installation and Activation of EMS for Outlook – Microsoft 365

1. From the downloads portal, download Ems.Web.Addin.msi.

2. Run the .msi file on your application server.

3. Enter the full path for the installation location and click Next.

4. Enter your environment's Platform Services URL and the virtual directory name you want. Click Next.

5. Click Install. You might be asked to provide admin consent.

On-prem Customers

Option 1:

On-premises customers should follow the same process as cloud customers to connect to EMS's Entra App instance.

1. Download the Manifest: Use the following URLs:

   1. Sandbox Manifest: https://emsoutlookweb-zue-ua.emscloudservice.com/manifest

   2. Production Manifest: https://emsoutlookweb-zue-pr.emscloudservice.com/manifest

2. Whitelist the following IP addresses in your firewall based on your hosted region to connect to EMS Platform Services:

Option 2:

Create an Entra App.

1. Create an App Registration at your tenant in Microsoft Entra ID.

2. In the Authentication Menu, add the Single-page Application platform.

3. Add the following Redirect URIs:

   1. The URI of your app (for example, https://myaddress.com)

   2. A special URI to grant Outlook access: (for example, brk-multihub://myaddress.com)

4. Provide the MSI installer with the Application ID from the overview page.

5. Install Ems.Web.Addin.msi with the addition of the App Id in the Platform Service URL during installation.

6. Download the Manifest. Use the following URL:

   1. On-prem customers: https://<YourCompany>.com/EmsWebAddin/manifest.xml

   2. The manifest file is hosted at the installation directory of the web add-in: app_url/manifest.xml
      

We recommend enabling the EMS for Outlook – Microsoft 365 add-in for a small set of users first to test the add-in before enabling it for the entire team.

For End Users

1. Download the Manifest File:

   1. On-prem customers: https://<YourCompany>.com/EmsWebAddin/manifest.xml

   2. Cloud customers:

      1. Sandbox Manifest: https://emsoutlookweb-zue-ua.emscloudservice.com/manifest

      2. Production Manifest: https://emsoutlookweb-zue-pr.emscloudservice.com/manifest

2. Install the Add-in:

   1. Click https://aka.ms/olksideload to open Outlook add-in management.

   2. Click My add-ins.

   3. Click Add a custom add-in.

   4. Select Add from File....

   5. Upload the downloaded manifest file.

   6. Click Install. If Outlook shows a warning about adding a custom add-in, select Install to continue.

For a more detailed walk-through, follow the instructions for adding a custom add-in.

For Exchange Administrators (Enabling for Entire Organization)

1. Go to Microsoft 365 Admin Center (https://admin.cloud.microsoft/), the select Settings > Integrated apps. Or directly to Integrated apps via this link: https://admin.cloud.microsoft/#/Settings/IntegratedApps

2. In Deployed apps menu, select Upload custom apps.

3. In Upload custom app fill the information:

   1. For App type select Office Add-in

   2. Select Provide link to manifest file.

   3. Insert the manifest URL for either Production (https://emsoutlookweb-zue-pr.emscloudservice.com/manifest ) or Sandbox (https://emsoutlookweb-zue-ua.emscloudservice.com/manifest)

   4. Click Validate.

      The Manifest file is validated and appears below the URL field.

4. Select Next, specify the users you wish to be granted access to the add-in:

   • Just me

   • Entire organization

   • Specific users/groups

5. On the next screen, review and accept the app permissions. Then selectNext.

6. Review the selected settings:

   • Apps to deploy: Outlook

   • Assigned users

   If the information is correct, select Finish deployment.

   Deployment can take up to 72 hours. You might need to restart Microsoft 365 to view the add-in icon on the app ribbon.

   To change user assignments, manage the add-in within Integrated apps.

Customers utilizing the EMS Entra App

Action Required:

• Uninstall and reinstall the manifest file for version 225.1.1. You won't need to reinstall the manifest file for future updates.

• Work with Professional Services or Support to provide allowable domains for EMS for Outlook web add-in connection.